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name prec unary? binary? 



function 
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boolean inclusive or 
boolean exclusive or 
boolean and 
left parenthesis 
right parenthesis 
integer multiplication 
integer addition 
18 bit halfword 
integer subtraction 
loiical A and B 
logical a or b 
inte£«r division 
logical not a»b 
logical a<b 
logical aOb 
logical a«b 
logical a>b 
logical a^b 
boolean* true is symbol 



known 



boolen* true if next 
integer remainder 
boolean not 
arithetic shift 
logical shift 



two tokens identical 



01 0006 

01 0007 

next pc routines 

16-WAY 

4-WAY 

8-WAY 

PC-ANY 

PC-EVEN 

PC-PLUS 1 

PC-PLUS20 



1 ist-nextpc 

set pc to first of a w word block 
set pc to first of a w word block 
set pc to first of a w word block 
pc+1 preferred* but anywhere is ok 
set pc to an even pair 
unconditional +1 
unconditional pc+20 
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1.0 CONCEPTS 

Sloe Is designee to be a general purpose assembler for microcode. 
As such* there are certain underlying assumptions about the architecture 
of the machines? and the desirable form cf the microcode to drive the 
machines. These assumptions will be stated shortly* 

Sloe 1s syntacticly direct. The only distinctions among characters 
are between 'separator* characters and all others. The only characters 
with any implied meaning are C 3 C ) $ : ; and * . This structure 
allows the widest possible latitude in the definition of symbols. 

Sloe is transformed from its Initial state into an assembler for 
some particular machine by making an appropriate set of declarations* 
corresponding to the architecture of the target machine. There is no 
separate procedure for declarations. As a design feature* all the 
capabilities for defining and extending the microcode are always 
available. in practice* there will be a parameter file tor each target 
machine sloe assembles for* but is always possible to extend the basic 
parameter In any compatible direction. 

Error checking is an intrinsic part of any assembler. Sloe 
diligently checks for many kinds of errors that are Implied by the 
declarations that have been made. Among these are multiple definitions* 
missina definitions* syntax errors* missing operands* unbalanced 



declarations were made. Loosely structured declarations will result 1n 
undetected errors. There 1s also provision for detecting ad hoc errors* 
those which are not deduced from the declared structure, but which 
nonetheless are impossible or undesirable 1n the actual hardware. 



2.0 THE MACHINE MODEL 

Here* we refer to the presumed propertied of the target machine 
which sloe 1s to assemble for. 
IL 
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2.1 Memories 

The target machine has one or more memories, each memory has Its 
own size and Its own word format. Memory words may be any width. The 
total number of bits 1n all memories 1s small; Less than a million. 
There 1s provision for automatically generating parity bits. 

2.2 Parallelism 

Micro machines are likely to have a large number of functions* many 
of which can operate 1n parallel. This gives the microcode a "do this 
and do that and do something else" flavor. 

2.3 Incompleteness 

Not all operations that can be encoded 1n an instruction can 
actually be executed by the hardware. For Instance* a multiplier and a 
shifter might both use an Internal bus* so both can*t be active 
simultaneously* even 1f the microcode could code for such an operation. 

2.4 Microinstructions 

Each microinstruction occupies exactly one word in one of the 
memories. Microinstruction format 1s hammlng-decodeable* though not 
necessarity Instantaneously. The Implied «next Instruction* may be 
other than . + 1* or may not even ^.aiiltl exist. The encoding of the 
microcode word can be expressed in terms Uke "If field A has value X 
and Field B has value Y* then field C can have values Cfl> CC2) or 
C<3>." 

3.0 BASIC ASSEMBLER SYNTAX 

SPACES are the characters <space> <tab> <cr> <lf> 

SEPARATORS are the characters C 3 f > * S 

NUMBERS are 0123456789 

LETTERS are A-Z a-z 

Lower case Is always equivalent to upper case 

SPECIALS are ell other printing characters 

SYLLABLE ANY sequence of LETTERS NUMBERS and SPECIALS 
It 
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or 
one SEPARATOR 

Notice that the group called SPECIALS Is not really special, only 
an amalgamation of all the other characters. Syntactically, they are 
never treated differently than letters or numbers. This 1s likely to 
cause seme consternation 1n expression evaluation, where the familiar 
syntax: A=B*C must be written as A = B * C However, This 1s a small 
encumberace 1n view of the power to define symbols like A>=B without 
confounding a well meaning syntax analyzer* 

The SEPARATORS group are the only characters that get special 
attention. They constitute a concession to convenience, with the cost 
that they cannot be Incorporated Into symbols. Each of the separators 
has a specific function associated with It 

$ terminates multl part declarations and microcode words 

( ) group expressions 1n the usual way 

C 3 group operands, values for microcode fields. 

1s the concat Inatlon character for the macro processor 
: defines a label 
» begins a comment to the end of line 

NOTICE that this 1s the only place where end of line 
1s not synonymous with a space 



4.0 SYMBOLS 

Any syllable which 1s not a separatcr can be defined as a symbol. 
Except for one case, nothing Is implied by the characters In a symbol, 
that is "A=B» "F00" »!!" -A-B" are all perfectly valid symbol names, and 
no arithmetic or logical operations are Implied by any of them. The one 
exception 1s the single quote character "•••, which 1s given special 
meaning 1n some restricted contexts. (see: FIELD VALUES) There are 
several subclasses of symbols, which are determined by the type of 
declaration, and which have different useful attributes affecting the 
assembly proces. Symbols of the save name with different attributes are 
sometimes permitted, but not encouraged. 
(L 
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4.1 PSEUDO OPERATORS 

Pseudo ops are the predefined elements of the language. Note that 
ALL of sloe's predefined language Is Implemented as pseudo ops * even 
those Hke assignment C = ) and label declaration C : ) which are not 
normally thought of es such* The pseudo ops will be described 1n detail 
later* 

example: 
declare-memory main 

10 1000 

"Dectare-memory" Is a pseudo op. In this case the one that sets the 
basic memory parameters; an 8-bit by 512-word memory. The rest of the 
text 1s Interpreted by the particular pseudo op processing routine. 
Note that end of line does not end the argument 11st, This 1s generally 
true. End of line 1s almost always equivalent to a space. 



4,2 MACROS 

Macros provide capability to extend the language processed. The 
macro processor 1s rtclmentary but functional, 

example: 

•OEFINE F00 I arc! arg2 1 
I argl = arg2 1 

Note that ARG1 and ARG2 are arbitrary syllables* and that there are 
no separators between them. The pseudo ops for defining macros and 
related construtlons will be described In detail later. 



4.3 FIELDS 

A field 1s a contiguous set of bits within a microcode word that 

requires a value be specified. Declaration of fields within the 

microcode of each memory 1n the target machine Is the basic operation 

that makes sloe an assembler for a particular machine* The stringency 

of the field declarations you make determines sloe's ability to detect 
errors 1n the microcode It assembles* 

EXAMPLE: C with the memory definition In the previous example) 
|L 
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OPCODE = FIELD 3 4$ 

Declares OPCODE as a 4 bit field* whose low order bit 1s bit 3, 
counting bit 0=leftmost bit. Internally* this generates a mask of the 
significant bits in the field within thenicrocode word: 

11110000 (binary) 



4.4 WORDS 

A field» with the required value specified* becomes a word. Words 
correspond directly to microcode words. The basic assembly operation 
consists of IOR ing together several word symbols* and Checking that IOR 
1ng the symbols together doesn't assign one part of the microcode word 
two different values. 

EXAMPLE: (extending the previous example) 

ADD = 0PC0DEL5D $ 

SUB = 0PCODEC63 $ 

Defines a ADD as a wcrd that has the following mask and value 
11110000 OPCODE field tbinary mask) 
01010000 ADD (value bits) 
01100000 SUB (value bits) 



Any attempt to change the value of a bit 
specified 1s an error. For instance: 

ADD SUB $ 



which has already been 



Generates an error message 1n the above example* because some bits 
of the OPCODE field are required to have two different values. This is 
the basis for most of SLOE's error checking. 

There are several variations on the basic FIELD and WORD types* 
which are for convenience and syntactic clarity* but are not essential 
to the concept. These embellishments will be described in detail later. 
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4.5 VALUES 

Value symbols associate s name with an Integer, The syntax to 
declare a value 1s 

valuename = expression 

Note that there must be spaces separating the = from the name and 

expression* The limits on expressions will be discussed 1n detail 

later* but briefly; an expression Involves only Integer numbers* 

numeric pseudo operators* labels* and previously defined values* 

.ike fields words and labels* can be redefined* 



4*6 LABELS 

Labels are values with additional attribute •label» attached. 
Labels are declared by the n i n pseudo op* 

for example: 

foo: 

Declares the label "FOO" at the current memory location* Unlike 
values* labels cannot be redefined* but unlike everything else* a label 
can be forward referenced* Fields can have the attribute of requiring a 
label to fill their vacancy* Any undefined symbols encountered 1n 
expressions are assumed to be forward references to labels* When the 
forward references are eventually resolved* the value is ADDED to the 
field* This means that expressions like: 

FCO ♦ N ;yhere FOO 1s a forward reference 
Will work* but expressions like: 

FOO ! N ;Where FOO 1s a forward reference 
W1 11 not work • u 



^ttfr 



4.7 NUMBERS 

A syllable which consists of only digits* possibly termlninated by 
a decimal point* can be Interpreted as a number* if all else fails* 
You CAM define such syllables as symbols* so caution is advised* Even 
numbers are not necessarily what they sees! 
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4.8 PCROUTS 

PCROUTS are a special class of pseudo operator* which specify an 
algorltm for selecting the location for the next microinstruction. For 
all syntactic purposes* PCROUTS are Identical to PSEUDOs* 
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5.0 BLOCKS 

A BLOCK 1s a group of syllables? delimited by correctly nested left 
and right markers. * left marker Is either a "C " or "BEGIN XXX»* where 
XXX 1s the name of the block. A right marker 1s either « 3" or 
"END XXX"* where XXX 1s the name of the block. The name of the block 
serves to enforce the matched closure of blocks. 
EXAMPLE: 

I »bec1nn1ng of ablock 

A = 1 
BEGIN F00 *beg1n a names block 

B = 1 
END FCO ;end of the named block 
1 fend of the unnamed block 

All of the constructs that expect BLOCKS as arguments allow blocks 
to be nestedt and Insist that named blocks be matched. 

Within this document* blocks will be referred to as XXX-BLOCK* 
where XXX 1s somewhat descriptive of the function of the block. Two 
caveats are 1n order: First* those descriptions that expUdty use C 
and D mean 1t. BEGIN F00 ... END FCO 1s not acceptable <for Instance* 
1n supplying field values. Second* do not confuse the use of the word 
BLOCK with the .BLOCK pseudo op* which Is totally unrelated. 
IL 



<foodoosloe.man;i 



Thu 17-Dec-81 6:26PM 



Page 9 



Page 9 



ASSEMBLER DIRECTIVES 



6.0 ASSEMBLER DIRECTIVES 

The following section describes each pseudo op in the current 
release of SLOE* 1n alphabetical order. Most pseudo ops are recognised 
In any context* but a few are recognised only in restricted contexts. 
These exceptions to the rule will be noted. 

SLOE pseudo ops are Implemented by ad-hoc subroutines. Those which 
require arguments usually use the standard parser* so their Input will 
look much like other SLOE constructions. Those which take numeric 
arguments are not restricted to simple numbers* but will accept an 
arbitrary expresion. 



6.1 $ 

The *$" pseudo op 1s used as a terminator, which returns 

assembler to 1t»s top level state from whatever sub context you are 

The two most important functions are: 



the 
in. 



$ terminates the scope of a FIELD pseudo op. 

$ terminates assembly of a microcode word* and Initiates the 
process of supplying default values for unspecified fields and for 
selecting the next microcode PC. 

$»s encountered when neither a FIELD declaration is in progress or 
a microcode word has been built will not cause any microcode to be 
generated or any error messages to be generated. So you can sprinkle 
$"s around to suit your taste* without fear of trashing anything. 



6.2 .BLOCK C lb Ub] <CX1> #**•*:# ... 

The .BLOCK pseudo op finds a block cf memory meeting constraints 
specified by the arguments. The next microinstruction will be assembled 
at location of the block. The .BLOCK pseudo op does not actually 
allocate the memory locations* but only assures that they 
Use the ■:* pseudo op to determine which location within 
block to use** or rely on the default sequencing* 1f that 
thing. 



are available. 

an allocated 

does the right 
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You can use .MARKOUT In conjunction with .BLOCK, to mark memory 
Locations used* 

For convenience and appearance* sake. .BLOCK uses a slightly 
nonstandard syntax 1n Its scan. A .BLOCK pseudo op 1s terminated by end 
of Unei unless the last character on the line 1s a comma or a colon; 
and «1tMn the "»,#:*?" part of the argument list, COMMA 1s considered to 
be a separator. This will cause confusion 1f you try to use expressions 
Involving symbols with commas 1n their names. 

It 1s also III aCvlsed to use the .BLOCK psuedo op In the middle of 
assembling a micro Instruclon? a warning message Is generated If you 
do. 

C lb ub ] 

specifies the bounds within memory what wilt be searched for a 
location that meets the other constraints Imposed. LB and UB 
default to and max-value respectively. LB and UB can be an 
expression rather than a constant. The whole of r lb ub 1 Is 
opt 1onal 

<0xl> 

1s entirely optional. 1f specified, 1t 1s a picture of the 
low order adress bits of the block to be found, x specifys a 
"don»t care" bit. If omitted, <xxxxx> 1s assumed (with enough 
x«s so any address will match). 

8 1s a number or expression 

«:# Is a range of numbers 



example: 

•BLOCK C . 1000 ] <100> o:3,ic 

Finds a block of memory between current micro PC and 1000, 
whose low order bits are 100 Iblnary), and for which the 0»th 
through 3»rd and 10'th following locations are unused. 

.BLOCK C . 3 <070,1 

Finos an even pair of memory locations, at some higher address 
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6,3 .DEFINE MACRONAME ARG-BLOCK BOOY-BLCCK 



The • 
f ol lowed 
and blocks 
argument 
are replac 
1s Invoked 
the flourl 
syllable 
be no extr 
dummy argu 

example: 

• DEF 
F00 



DEFINE pseudo op declares a macr 
by a syllable* the name of the mac 
. Every syllable 1n ARG-BLOCK 
tcr the macro* and all occurences o 
ed by the actual arguments supplied 
This Is the usual macro capability 
shes that are available 1n HACRO-10 
1r the argument list Is an argument 
aneous syllables (such as commas) 
ments 



o. It must be 
ro being defined* 
becomes a dummy 
f dummy arguments 

when the macro 
* without some of 

or FAIL. Every 

« so there should 

separating the 



IKE FCO CAB3CAsB3? define the macro "FOG" 
C XY2 1 ; evaluates to * XY2 = * 



6.4 .FOR FORMAL AR6-BL0CK BLOCK 

The .FOR construct provlces an Immediate execution macro 
capability* similar to the FOR construct In FAIL. The above example 1s 
equivalent to the following: 

•DEFINE xxx [ FORMAL 3 BLOCK 
XXX C argl 1 
XXX C arg2 ] 
••• and so on for each syllable 1n arg-block 

Were XXX 1s a temporary macro. .FOR statements can be nested to 
any reasonable level. For example: 

•FOR A C B C 3 C .FOR DCEF3CA*D=03D 
evaluates as: BE = BF = CE = CF = 



6.5 .^EXPRESSION TRUE-BLOCK ELSE FALSE-BLOCK 



The .IF pseudo op provides a mechanism for conditionally assembUno 
code Into a program. EXPRESSION can be any boolean expression. If the 
expression evaluates to TRUE* then TRUE-BLOCK Is assembled* otherwise 1t 
Is skipped. If the next syllable after termination of TRUE-BLOCK 1s 



•ELSE'S then FALSE-BLOCK Is 
appropriately. .IFs can be 
LIST-OPERATORS pseudo ops for a 
*' fxAMPLE: 
I'L 



scanned for and executed (or not) 
nested to any reasonable level. See the 
list of the conditions available. 
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.IF A C B = B / A 1 ELSE C B = 1 

6.6 .INSERT FUespet 

Causes the named file to be Inserted Into the assembly. The 
default extension is .SLO. .INSERTS can be nested to any reasonable 
level. 



6.7 .MARKOUT #,#:* 

•MARKOUT marks the microcode memory locations listed as USED. The 
format of the argument list 1s Identical to the corresponding part of 
the .BLOCK pseudo op. Error messages are generated if any marked out 
loctlons are already used, or If any subsequent attempt is made to use a 
marked out location. 

Markout Is Intended to allow you to Interdict memory locations that 
are nonexistent or dedicated to other use, so they will not be selected 
by the pc sequencing mechanisms. 
IL 
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The grammar recognised by SLOE is context sensitive and syntax 
driven. Therefore, the kind of entity expected depends on the current 
context. Symbol tables are searched for 1n a predefined order in each 



context. 



7.1 GLOBAL Context 



Which 1s where you start, and where you return each time a $ Is 
encountered. Here, one makes declarations, gives assembler directives, 
or starts assembling microcode words. In order of scan, 

MACROS Macros have highest priority. A macro with the 

same name as a pseudo op effectively replaces It. 

PSEUOO OPS pseucc ops are the Deans of directing the assembly. 
The pseudo ops will be described 1n detail later. 

PCROUTS Which are syntacticly equivalent to pseudos 

FIELDS microcode definitions 

Note that numbers and numeric expressions are NOT acceptable in 
this context. 



7.2 FIELDS 

Whenever the name of a field 1s encountered, a special local 
context 1s entered, where a special set of field value names are 
recognised. In order of search: 

FIELD VALUES associated with the field immediately following 
the FIELD pseudo op, or after a HODIFY-FIELD pseudo op 

FIELD VALUES of other fields, allowed In this context by the ALLOW 
pseudo op 

NUMERIC EXPRESSIONS 
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7.3 DECLARATIONS 

Declaration context 1s entered by the "=" pseudo op. Within 
declaration context* several additional symbol types are searched* 
and numeric expressions are allowed. 

PCROUTS a special set of symbols* corresponding to the 
algorithm for assigning the location of the next 
micro Instruction to be assembled. 

DEFOPS a few special words like DEFAULT. 



7.4 EXPRESSIONS 

Numeric expressions are legal within declaration syntax, and 
secondarily, when no subfield 1s found to complete a field 
reference • 

OPERATORS operator symbols become available, and have first 

scan priority within expressions. 
LABELS labels defined with »:■ 
VALUES Integer symbols defined with = 
NUMBERS syllables that are logically numbers. 
FIELDS 



7.4.1 "short" And "long" Word Names - 

In one context, a shorter than complete name of a word Is 
recognised. This provides a limited facility to have apparently the 
same word have different values 1n different contexts. The single 
quote character: »•" Is treated as a terminator for a symbol name 
within the restricted context of a field requiring a value. 
Example: 

OPCODE s FIELD 5 5 
ADD*0P = 1 
SUB = 2 J. 
ADD = OPCODE 3 $ 
OPCODECADD] S 
ADD % 

In the example, OPCODECADD] 1s equivalent to OPCCDEC ADD*0P3, 
whereas ADD $ 1s equivalent to CPC0DEC33 $ 
|L 
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ADD'OP 1s recognised "anywhere", but "ADD" 1s recognised as 
equivalent to "ADD'OP" only when the enclosing field "OPCODE" has 
been explicitly mentioned. 

It Is Intended that names without Imbedded "»"s be given only 
to symbols that are to be referencable from top level, without 
explicitly mentioning the enclosing field* 



7. 4*2 Optional Forms For Field Values - 

There are three optional forms for spedfylno a field value 
word. From the above example: 

SUB $ 

OPCODE SUB $ 
0PC0DECSUB3 S 

ADD»0P $ 

OPCODE ADD $ 

OPCODE ADD % 

All three forms 1n each group are equivalent. Which form Is 
used 1s a matter of preference, except when the field ALLOWS (see 
ALLOW Pseudo op wrlteup) more than one actual fields values to be 
specified. in that case, the bracketed form must be used 1s more 
than one value 1s actually specified. 
IL 
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•block ••••••••••••••9 
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Asembler directives •••••••9 
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Conditional assembly ••••••• 11 
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L 
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Parallelism ..* 2 
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Separators •••••••••••• 2*3 

Short names •••••••••••14 
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Memory specifications 

Sloe can slmul t an lous ly assemble code into any number of 
different memories* *ith different sizes and field properties. 
AT LEAST ONE memory must be declared before any significant 
assembling can be dene. 

OEFINE-MEMORY memory-name tsubclass Hst3 bit-size words-long 

SUBCLASS LIST is a list of »extra» 1 bit fields (more laterl 
BIT-SIZE is the width of the memory* excluding the class list 
WORDS-LONG is the length of the memory 

declares a new memory and selects it to be current, 

SELECT memory-name 

selects a declared memory as current 

LIST-MEMORIES 

lists the properties cf declared memories. 

DEFAULT-PC xxx 

selects mode xxx as the default next pc selector. See the PC CONTROL 
section cf this document. 



in addition to BITSIZE and W0RDSIZE» each memory has other 
properties preserved ever memory switches. These are: 

LOCATION COUNTER 

ALLOCATION MAF 

FIELDS LIST 

NEXT-PC SELECTOR 

SUBCLASS LIST 

PARITY GENERATION SPECIFICATION 

NOT included in the per memory stuff is 
VARIABLES LIST 
MACROS LIST 
LABELS LIST 
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Self Cocumentation Features 

There are a number of psudo ops that dump documentation 
Into the listing file. The documentation so dumped 1s 
gaurenteed to be current* since It 1s created at compile time 
and 1s an Integral part of the assembler. 

LIST-PSUDOS 

•• 1$ the most Important* since It lists the 11st of lists* 
others that exist at the time this file was last updated are: 

LIST-CORMAP print memory allocation map 

of your assembled program 
LIST-FIELDS Ust all the field definitions 

very useful to see 1f everything 

1s as you expect! 
LIST-OPERATORS Ust the arithmetic expression 

operators 

LIST-MEMORIES Ust name and sizes of defined memories 

LIST-NEXTPC list the available next-pc operators 

LIST-LABELS list label-to-address symbol table 

LIST-SYMBOLS list the integer symbols defined 

LIST-PARITY list the parity generation specification 

SYMBOLS 

SYMBOL TOKENS are bounded by separator characters, 
the separator set 1s: 

$ : ; C 1 C ) space tab line feed 

the separator set does NOT Include 
< = >!&/ \ * 

SYMBOL TOKENS can Include any characters not in the separator set. 
as FIELD VALUES* tokens are scanned onlu as far as the first 
single quote ( » » character. This makes it convenient to 
define local names that possibly conflict with global names. 

example: 

FIELD F00 s p $ 
FIELD ABC S p 
FOO^abc a 3 $ 
now FOO references field F00 

ABC FOO references field ABC 
F0O*ABC references field ABC 
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example: 

ALUCA+B] $ is parsed as ALU C A*B D $ 
ALUCA + Bl $ is parsed as ALU C A ♦ B 1 % 

SYMBOL TYPES 

User defined symbols can be of several types 

a: defines label A* Also* an undefined reference 1n a 

LABEL type field Implicitly creates a label ? whose 
value will be defined later* 

A = expr defines a simple variable* MOTE that the space between 

the A and = 1s necessary! 

A = FIELD s p $ 

defines a FIELD within a microcode word* 

S 1s the size of the field 1n bits 

P is the number of the low order bit of the field* 

with bit zero at the left* 
Synt act Ically • a field defined this way requires 
a value specification to follow 1t. 
A = FIELD s p 

VALUE1 = n 
VALUE2 = k 

• • • 
VALUEN = z S 

defines a field which has named values. The values 
may be used as value specification for the field* or* 
if unique* may be used to Imply the field* 

FOR example: 

FOOBAR = FIELC 5 5 ideflne a 5 It field ending 5 bits fro 

F00-1 = tend of microcode word 

F00-2 ~ 2 % ;F00-1 and F00-2 are possible values 

FOOBAR 4 $ 

FOOBAR F00-1 $ 
FOO-2 $ Jail specify the FOOBAR field 

****** COMPLEX FIELD DEFINITIONS ***** 

special modifiers for field definitions* 

LABEL before the S ending the field definition 

specifies that the value of the field 1s a label 

FOOBAR = FIELD 5 5 LABEL $ 
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DEFAULT after a subfield specification specified that this 

1s to be the field's default value* 

FOOBAR s FIELD 5 5 
F00-1 = 
FOO-2 = 1 DEFAULT 
F00-3 = 2 t 



NOVALUE 



after a field value definition* specifies that 
this cef1n1t1on does not supply a value for the field. 
This allows unrelated specifications to be included 
in the field for syntactic clarity 

FOOBAR = FIELD 5 5 
F00-1 = 
FOO-2 = 1 

STROBE = XYZ 3 NOVALUE 
F00-3 = 3 $ 

FOOBAR C FOO-2 STROBE ] $ 

restrictions and Implied fields can be added to field 'specif 1cat Ions 
and field value specifications, 

FOOBAR = XXX 3 YYY 4 FIELD 5 5 
F00-1 = IZltll 
FOO-2 = 2 DEFAULT 
F00-3 = XYZ f NOVALUE $ 

This specifies that FOOBAR ( or subflelds > 
set XXX field to 3 and YYY field to 4 f 
as well as requiring a value for the field. 
F00-1 also sets ZZZ field to 3 
FOO-2 atso sets XZY field to 4* and specifies 
no value for FOOBAR 

The 'subclass list* of each memory Is a list of names of 1 Bit 
fleldst which are not part of the f real* microcode word* Unlike all 
fields which are part of the microcode word* class 11st fields 
do not have to be specified ( or defaulted > 1n every microcode 
word* All the usual operations can be done with the class 
11st fields* This permits you to set up arbitrary restrictions 
in microcode* 

example: 

Declare-aemory main C SPECIAL 3 10 1000 

F00 = FIELD 4 3 

BAR = SPECIAL 1 1 ?spedal on 

BAZ = SPECIAL 1 $ Jspeclal off 
F002 = FIELD 4 7 

FOOZ = SPECIAL 1 $ 
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* NOW* the mlcorcode word 

F00 CBAR3 F002CFOOZ3 $ 
; uHl cause an error message •FCC2 fcauses a field conflict* 
; because F002CFOGZ3 requires SPECIALC03 and F00CBAR3 requires 
J SPECIALC13 

Finally* fields can require another f1eld»s value be specified. 

S = FIELD 12 30 LABEL $ 
JCODE = FIELD 3 20 

JUMP = a T 3 7 

NEVER = 3 DEFAULT 

PUSHJ = 3 C3 4 

POPJ = 5 $ 

defines JC0DECNEVER3 as the default specification* 
but if JUMP or PUSHJ 1s used* an address must be 
specified as well. 

JUMP F00 * 

and 
JCODE 4 a FOC $ 

•• are now equivalent. 



A = BIT P V $ 



is eculvalent to: 
A-FIELD = FIELD P 1 

A = V DEFAULT $ 
1f V is omitted* 1 1s assumed 

This is a convenient mechanism for defining control 
bit fields. All the other elaborations of FIELD 
definitions can be used too. 



******************************************************************* 



Memory allocation etc. 
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************************************************* ****************** 

Before anything* you must declare the microcode wordslze 

DECLARE-PEMGRY memory-name bitsUe wordslze 

memory-name 1s the name of the memory 
bltsize 1s the number of bits wide 1t Is 
wordslze 1s the number of words long It Is 

any number of memories can be declared* and you can switch assembly 
Into any of them with 

SELECT memory-name 

: nnn where nnn Is a number* expression* or simple variable 

sets the location counter to nnn 
A: defines a new label at the current location counter 

: A ♦ nn sets the location counter to a relative location 

•BLOCK Clb ubl <0xl> *,«»#:# ... 

finds a block of memory locations* meeting constraints Imposed 

[ lb ub ] 

specifies the bounds within memory what will be searched for 
a location that meets the other constraints imposed* LB 
and UB default to and max-value respectively. LB and UB 
can also be an expression rather than a constant* 
The whole of r lb ub ] Is optional 

<0xl> Is entirely optional, if specified* 

it 1s a picture of the low order adress bits of the block 

to be found* x speclfys a ■Oon*t care* bit. 
# Is a number or evpression 
#:# is a range of numbers 

•HARKOUT #»#:« ... 

marks specified memory locations* relative to the 
current location counter* as used. 

*********************************** ************************ ****** 

PARITY GENERATION 
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******************** * **************** ******************* ********* 

Each memory has a parity generation sped f 1cat1onf which 
can be declared anytime before final output Is written* 

GEN-PARITY type mask-field data-field 

TYPE must be the word "ODD" or "EVEN" 

MASK-FIELD can be any field. The bits masked by 

the field are counted for the calculation 
DATA-FIELD can be any 1-BIT field* Data-field will 

be stuffed with the desired parity 

There can be any number of different parity specifications; 
The calculations are performed 1n the order originally specified. 
It 1s posslblef therefore* to autoatlcally caculate separate parity 
for different parts of the word? or even to generate error 
correcting codes! 

The LIST-PARITY pseudo-op lists the parity generation 
sequence for the current memory. 

***************************************************************** 

Next FC control 
***************************************************************** 

The vagarlties of PC control are handled through a special 
mechanism* There are a number »next pc* selectors (PCCs) available* 
more will be generated on request. Currently available: 

PC + 1 unconditionally the next memory location 

PC + 20 unconditionally PC + 20 

PC-EVEN the even location of a pair of free locations 

PC-ANY PC+1 If available* but any if not. 

In genral* any set cf constraints to the .BLOCK psudo op could 
be used. Any zero-argument macro which manipulates the location 
counter can be added to the List with the DECLARE-NEW-PC psudo-op 

CECLARE-NEW-PC macroname newpc-name comment-t o-end-of -I 1 ne 

macroname must be a zero-arg macro 

newpc-name will be 1t*s alias as a new-pc generator 

the rest of the line 1s a comment* which will be 
printed by the LIST-NEXTPC psudo op 

example: 

DECLARE-NEW-PC FUBAR PC-MYUAY do 1t the right way! 
wilt set up the macro FUBAR as PC-MYWAY In 
the PCROUTS list 
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At any moment, one cf the PCCs is the default* set with the 
DEFAULT-PC psudo op. 

DEFAULT-PC *xxx 

sets the pc selector. The default cefault pc-selector 1s PC+1. 

Now* any FIELD can imply a non-default pc selector, for instance: 

FIELD PC-MOD 2 2 

NO-SKIP = default 

SKIP-USER = PC-EVEN 1 

SKIP-EXEC = PC-EVEN 2 $ 

now. asserting SKIP-USER in a microcode word also causes 
the sequencer to select an appropriately constrained location as the 
default next. 

In adcition to selecting a default next pet it 1s sometimes 
necessary to assure that that value 1s used in some label field. 
For Instance* on FOONLY* the Next address field nust be filled. 
LABEL type fields are allowed to have a Oefault value* and 
two useful special labels are available. 

• is the current location counter 

NAF is the default next location counter 

FIELD NEXT-ADR 10 10 

NAF» = DEFAULT $ default pc to NAFm whatever 

♦that may evaluate to be. 

FIELD NEXT-ADR-2 10 20 

. = 1 DEFAULT $ Jdetault to .♦! 



***************************************************** ******** 

Conditional compilation 
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******* ************************************************* 



•IF <boolean expression> <block> else <block> 



Is the basic syntax for conditionals. the ELSE and 
the second block are optional. 

Block can be either 

BEGIN any-token 

• • • 
END any-token 

or 

C ... 3 



■potSfJi 

won 



example: 

.IF A > C E = 1 ] ELSE 
BEGIN F00 
B = b ♦ 1 

C = 6 * A 
END F00 



*********************** ********************************** 

Repeat* Fort Pacros etc. 

************************************************* ******** 

.REPEAT <expression> <block> 

repeats BLOCK however many times* possibly zero. 

example: 

•repeat a+2cb=b*23 

.repeat begin f00 

this is a random comment 

ENC FOO 
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•DEFINE <macroname> <arg-block> <body-blcck> 

ceflnes a macro* 

MACRONAME Is any valid token 

ARG-BLOCK is a block. ALL the tokens within the block 

are formal arguments, max of 127. 
BODY-BLOCK 1s a block to substitute the formats In 
the usual way. 
1s the concat 1nat ion character 

example: 

.define f00 tab] 

BEGIN XX 

A*B = A ♦ B 
END XX 

•DEFINE F00 BEGIN AR6S ABC END ARGS 
BEGIN BODY 

A B C $ 
END BODY 



•FOR <formalname> <aetuals> <body> 

cefines a repetitive replacement of FORMALNAME 

with each of the actlals. Much Uke Fall 



example: 

•FOR A [ B C C 3 
C A = 3 

evaluates to 

B = 
C = 
D = 
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***************»****, ****************»******************#*«****„*» 

Labels and expressions 

************* *M*tt«,,M*#**********»0****.*«*********M*t*t**t** 

Labels* unlike fieldnames, may be forward referenced; both in 
defined words and code words 

ERROR = JUMP BUGHLT $ 
1s a valud deflntion, even if BUGHLT is currently undefined 

CAVEAT arithmetic performed with forwaro referenced tables is 
valid for simple + and - operations only* 
JUMP CFOO ♦ 11 is always valid 

wUMP CFOO ! 1] is valid only if F00 is defined 

IL 
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Special Notes for the export version 

The ususaL commands begin with a : 

jD CcontroL C> calls DDT* return with |E 

!foo abed (up to four arguments) calls trip function F00 

TAPE output format Is 8 bit bytes* (tape frames) 
2000. frames In a reccrdt changable by setting EUFSIZ 

<adr-h1gh><adr-low> <8b1ts data><8b1ts cata> ...Obits data> 
enough 8b1t data bytes to contain the whole word* however long 
that may be 

mlcrocooe word groups are output 1n the order encountered 1n the 
assembl y 



file 1s terminated by an adr of 177777 



